home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / djgpp / cplusinc / streambu.h < prev    next >
C/C++ Source or Header  |  1994-12-18  |  16KB  |  469 lines
  1. /* This is part of libio/iostream, providing -*- C++ -*- input/output.
  2. Copyright (C) 1993 Free Software Foundation
  3.  
  4. This file is part of the GNU IO Library.  This library is free
  5. software; you can redistribute it and/or modify it under the
  6. terms of the GNU General Public License as published by the
  7. Free Software Foundation; either version 2, or (at your option)
  8. any later version.
  9.  
  10. This library is distributed in the hope that it will be useful,
  11. but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13. GNU General Public License for more details.
  14.  
  15. You should have received a copy of the GNU General Public License
  16. along with GNU CC; see the file COPYING.  If not, write to
  17. the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  18.  
  19. As a special exception, if you link this library with files
  20. compiled with a GNU compiler to produce an executable, this does not cause
  21. the resulting executable to be covered by the GNU General Public License.
  22. This exception does not however invalidate any other reasons why
  23. the executable file might be covered by the GNU General Public License. */
  24.  
  25. #ifndef _STREAMBUF_H
  26. #define _STREAMBUF_H
  27. #ifdef __GNUG__
  28. #pragma interface
  29. #endif
  30.  
  31. /* #define _G_IO_THROW */ /* Not implemented:  ios::failure */
  32.  
  33. // #define _IO_NEW_STREAMS // Future optimization, turned off for now.
  34.  
  35. extern "C" {
  36. #include <libio.h>
  37. }
  38. //#include <_G_config.h>
  39. #ifdef _IO_NEED_STDARG_H
  40. #include <stdarg.h>
  41. #endif
  42. #ifndef _IO_va_list
  43. #define _IO_va_list char *
  44. #endif
  45.  
  46. #ifndef EOF
  47. #define EOF (-1)
  48. #endif
  49. #ifndef NULL
  50. #ifdef __GNUC__
  51. #define NULL ((void*)0)
  52. #else
  53. #define NULL (0)
  54. #endif
  55. #endif
  56.  
  57. #ifndef _IO_wchar_t
  58. #define _IO_wchar_t short
  59. #endif
  60.  
  61. class istream; /* Work-around for a g++ name mangling bug. Fixed in 2.6. */
  62. class ostream; class streambuf;
  63.  
  64. // In case some header files defines these as macros.
  65. #undef open
  66. #undef close
  67.  
  68. extern "C" int __underflow(struct _IO_FILE*);
  69. extern "C" int __overflow(struct _IO_FILE*, int);
  70.  
  71. typedef _IO_off_t streamoff;
  72. typedef _IO_fpos_t streampos;
  73. typedef _IO_ssize_t streamsize;
  74.  
  75. typedef unsigned long __fmtflags;
  76. typedef unsigned char __iostate;
  77.  
  78. struct _ios_fields
  79. { // The data members of an ios.
  80.   // Directly using _strbuf is dangerous, because the vtable
  81.   // pointer can be NULL.  Use rdbuf() when in doubt.
  82.     streambuf *_strbuf;
  83.     ostream* _tie;
  84.     int _width;
  85.     __fmtflags _flags;
  86.     _IO_wchar_t _fill;
  87.     __iostate _state;
  88.     __iostate _exceptions;
  89.     int _precision;
  90.  
  91.     void *_arrays; /* Support for ios::iword and ios::pword. */
  92. };
  93.  
  94. #define _IOS_GOOD    0
  95. #define _IOS_EOF    1
  96. #define _IOS_FAIL    2
  97. #define _IOS_BAD    4
  98.  
  99. #define _IO_INPUT    1
  100. #define _IO_OUTPUT    2
  101. #define _IO_ATEND    4
  102. #define _IO_APPEND    8
  103. #define _IO_TRUNC    16
  104. #define _IO_NOCREATE    32
  105. #define _IO_NOREPLACE    64
  106. #define _IO_BIN        128
  107.  
  108. #ifdef _STREAM_COMPAT
  109. enum state_value {
  110.     _good = _IOS_GOOD,
  111.     _eof = _IOS_EOF,
  112.     _fail = _IOS_FAIL,
  113.     _bad = _IOS_BAD };
  114. enum open_mode {
  115.     input = _IO_INPUT,
  116.     output = _IO_OUTPUT,
  117.     atend = _IO_ATEND,
  118.     append = _IO_APPEND };
  119. #endif
  120.  
  121. class ios : public _ios_fields {
  122.   ios& operator=(ios&);  /* Not allowed! */
  123.   public:
  124.     typedef __fmtflags fmtflags;
  125.     typedef int iostate;
  126.     typedef int openmode;
  127.     typedef int streamsize;
  128.     enum io_state {
  129.     goodbit = _IOS_GOOD,
  130.     eofbit = _IOS_EOF,
  131.     failbit = _IOS_FAIL,
  132.     badbit = _IOS_BAD };
  133.     enum open_mode {
  134.     in = _IO_INPUT,
  135.     out = _IO_OUTPUT,
  136.     ate = _IO_ATEND,
  137.     app = _IO_APPEND,
  138.     trunc = _IO_TRUNC,
  139.     nocreate = _IO_NOCREATE,
  140.     noreplace = _IO_NOREPLACE,
  141.     bin = _IOS_BIN };
  142.     enum seek_dir { beg, cur, end};
  143.     // ANSI: typedef enum seek_dir seekdir; etc
  144.     // NOTE: If adding flags here, before to update ios::bitalloc().
  145.     enum { skipws=_IO_SKIPWS,
  146.        left=_IO_LEFT, right=_IO_RIGHT, internal=_IO_INTERNAL,
  147.        dec=_IO_DEC, oct=_IO_OCT, hex=_IO_HEX,
  148.        showbase=_IO_SHOWBASE, showpoint=_IO_SHOWPOINT,
  149.        uppercase=_IO_UPPERCASE, showpos=_IO_SHOWPOS,
  150.        scientific=_IO_SCIENTIFIC, fixed=_IO_FIXED,
  151.        unitbuf=_IO_UNITBUF, stdio=_IO_STDIO
  152. #ifndef _IO_NEW_STREAMS
  153.        , dont_close=_IO_DONT_CLOSE // Don't delete streambuf on stream destruction
  154. #endif
  155.        };
  156.     enum { // Masks.
  157.     basefield=dec+oct+hex,
  158.     floatfield = scientific+fixed,
  159.     adjustfield = left+right+internal
  160.     };
  161.  
  162. #ifdef _IO_THROW
  163.     class failure : public xmsg {
  164.     ios* _stream;
  165.       public:
  166.     failure(ios* stream) { _stream = stream; }
  167.     failure(string cause, ios* stream) { _stream = stream; }
  168.     ios* rdios() const { return _stream; }
  169.     };
  170. #endif
  171.  
  172.     ostream* tie() const { return _tie; }
  173.     ostream* tie(ostream* val) { ostream* save=_tie; _tie=val; return save; }
  174.  
  175.     // Methods to change the format state.
  176.     _IO_wchar_t fill() const { return (_IO_wchar_t)_fill; }
  177.     _IO_wchar_t fill(_IO_wchar_t newf)
  178.     {_IO_wchar_t oldf = (_IO_wchar_t)_fill; _fill = (char)newf; return oldf;}
  179.     fmtflags flags() const { return _flags; }
  180.     fmtflags flags(fmtflags new_val) {
  181.     fmtflags old_val = _flags; _flags = new_val; return old_val; }
  182.     int precision() const { return _precision; }
  183.     int precision(int newp) {
  184.     unsigned short oldp = _precision; _precision = (unsigned short)newp;
  185.     return oldp; }
  186.     fmtflags setf(fmtflags val) {
  187.     fmtflags oldbits = _flags;
  188.     _flags |= val; return oldbits; }
  189.     fmtflags setf(fmtflags val, fmtflags mask) {
  190.     fmtflags oldbits = _flags;
  191.     _flags = (_flags & ~mask) | (val & mask); return oldbits; }
  192.     fmtflags unsetf(fmtflags mask) {
  193.     fmtflags oldbits = _flags;
  194.     _flags &= ~mask; return oldbits; }
  195.     int width() const { return _width; }
  196.     int width(int val) { int save = _width; _width = val; return save; }
  197.  
  198. #ifdef _IO_THROW
  199.     void _throw_failure() const { throw new ios::failure(this); }
  200. #else
  201.     void _throw_failure() const { }
  202. #endif
  203. #ifdef _STREAM_COMPAT
  204.     void _IO_fix_vtable();  /* TEMPORARY - for binary compatibility */
  205.     void _IO_fix_vtable() const; /* TEMPORARY - for binary compatibility */
  206. #endif
  207.     void clear(iostate state = 0) {
  208.     _state = _strbuf ? state : state|badbit;
  209.     if (_state & _exceptions) _throw_failure(); }
  210.     void set(iostate flag) { _state |= flag;
  211.     if (_state & _exceptions) _throw_failure(); }
  212.     void setstate(iostate flag) { _state |= flag; // ANSI
  213.     if (_state & _exceptions) _throw_failure(); }
  214.     int good() const { return _state == 0; }
  215.     int eof() const { return _state & ios::eofbit; }
  216.     int fail() const { return _state & (ios::badbit|ios::failbit); }
  217.     int bad() const { return _state & ios::badbit; }
  218.     iostate rdstate() const { return _state; }
  219.     operator void*() const { return fail() ? (void*)0 : (void*)(-1); }
  220.     int operator!() const { return fail(); }
  221.     iostate exceptions() const { return _exceptions; }
  222.     void exceptions(iostate enable) {
  223.     _exceptions = enable;
  224.     if (_state & _exceptions) _throw_failure(); }
  225.  
  226.     streambuf* rdbuf() const { return _strbuf; }
  227.     streambuf* rdbuf(streambuf *_s) {
  228.       streambuf *_old = _strbuf; _strbuf = _s; clear (); return _old; }
  229.  
  230.     static int sync_with_stdio(int on);
  231.     static void sync_with_stdio() { sync_with_stdio(1); }
  232.     static fmtflags bitalloc();
  233.     static int xalloc();
  234.     void*& pword(int);
  235.     void* pword(int) const;
  236.     long& iword(int);
  237.     long iword(int) const;
  238.  
  239. #ifdef _STREAM_COMPAT
  240.     void unset(state_value flag) { _state &= ~flag; }
  241.     void close();
  242.     int is_open();
  243.     int readable();
  244.     int writable();
  245. #endif
  246.  
  247.     // Used to initialize standard streams. Not needed in this implementation.
  248.     class Init {
  249.     public:
  250.       Init () { }
  251.     };
  252.  
  253.   protected:
  254.     ios(streambuf* sb = 0, ostream* tie_to = 0);
  255.     virtual ~ios();
  256.     void init(streambuf* sb, ostream* tie = 0);
  257. };
  258.  
  259. #if __GNUG__==1
  260. typedef int _seek_dir;
  261. #else
  262. typedef ios::seek_dir _seek_dir;
  263. #endif
  264.  
  265. // Magic numbers and bits for the _flags field.
  266. // The magic numbers use the high-order bits of _flags;
  267. // the remaining bits are abailable for variable flags.
  268. // Note: The magic numbers must all be negative if stdio
  269. // emulation is desired.
  270.  
  271. // A streammarker remembers a position in a buffer.
  272. // You are guaranteed to be able to seek back to it if it is saving().
  273. class streammarker : private _IO_marker {
  274.     friend class streambuf;
  275.     void set_offset(int offset) { _pos = offset; }
  276.   public:
  277.     streammarker(streambuf *sb);
  278.     ~streammarker();
  279.     int saving() { return  1; }
  280.     int delta(streammarker&);
  281.     int delta();
  282. };
  283.  
  284. extern unsigned __adjust_column(unsigned start, const char *line, int count);
  285.  
  286. struct streambuf : public _IO_FILE { // protected??
  287.     friend class ios;
  288.     friend class istream;
  289.     friend class ostream;
  290.     friend class streammarker;
  291.     const void *&_vtable() { return *(const void**)((_IO_FILE*)this + 1); }
  292.   protected:
  293.     static streambuf* _list_all; /* List of open streambufs. */
  294.     _IO_FILE*& xchain() { return _chain; }
  295.     void _un_link();
  296.     void _link_in();
  297.     char* gptr() const
  298.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_base : _IO_read_ptr; }
  299.     char* pptr() const { return _IO_write_ptr; }
  300.     char* egptr() const
  301.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_end : _IO_read_end; }
  302.     char* epptr() const { return _IO_write_end; }
  303.     char* pbase() const { return _IO_write_base; }
  304.     char* eback() const
  305.       { return _IO_file_flags & _IO_IN_BACKUP ? _IO_save_base : _IO_read_base;}
  306.     char* base() const { return _IO_buf_base; }
  307.     char* ebuf() const { return _IO_buf_end; }
  308.     int blen() const { return _IO_buf_end - _IO_buf_base; }
  309.     void xput_char(char c) { *_IO_write_ptr++ = c; }
  310.     int xflags() { return _IO_file_flags; }
  311.     int xflags(int f) {int fl = _IO_file_flags; _IO_file_flags = f; return fl;}
  312.     void xsetflags(int f) { _IO_file_flags |= f; }
  313.     void xsetflags(int f, int mask)
  314.       { _IO_file_flags = (_IO_file_flags & ~mask) | (f & mask); }
  315.     void gbump(int n)
  316.       { _IO_file_flags & _IO_IN_BACKUP ? (_IO_save_base+=n):(_IO_read_ptr+=n);}
  317.     void pbump(int n) { _IO_write_ptr += n; }
  318.     void setb(char* b, char* eb, int a=0);
  319.     void setp(char* p, char* ep)
  320.       { _IO_write_base=_IO_write_ptr=p; _IO_write_end=ep; }
  321.     void setg(char* eb, char* g, char *eg) {
  322.       if (_IO_file_flags & _IO_IN_BACKUP) _IO_free_backup_area(this); 
  323.       _IO_read_base = eb; _IO_read_ptr = g; _IO_read_end = eg; }
  324.     char *shortbuf() { return _shortbuf; }
  325.  
  326.     int in_backup() { return _flags & _IO_IN_BACKUP; }
  327.     // The start of the main get area:  FIXME:  wrong for write-mode filebuf?
  328.     char *Gbase() { return in_backup() ? _IO_save_base : _IO_read_base; }
  329.     // The end of the main get area:
  330.     char *eGptr() { return in_backup() ? _IO_save_end : _IO_read_end; }
  331.     // The start of the backup area:
  332.     char *Bbase() { return in_backup() ? _IO_read_base : _IO_save_base; }
  333.     char *Bptr() { return _IO_backup_base; }
  334.     // The end of the backup area:
  335.     char *eBptr() { return in_backup() ? _IO_read_end : _IO_save_end; }
  336.     char *Nbase() { return _IO_save_base; }
  337.     char *eNptr() { return _IO_save_end; }
  338.     int have_backup() { return _IO_save_base != NULL; }
  339.     int have_markers() { return _markers != NULL; }
  340.     void free_backup_area();
  341.     void unsave_markers(); // Make all streammarkers !saving().
  342.     int put_mode() { return _flags & _IO_CURRENTLY_PUTTING; }
  343.     int switch_to_get_mode();
  344.     
  345.     streambuf(int flags=0);
  346.   public:
  347.     static int flush_all();
  348.     static void flush_all_linebuffered(); // Flush all line buffered files.
  349.     virtual int underflow(); // Leave public for now
  350.     virtual int overflow(int c = EOF); // Leave public for now
  351.     virtual int doallocate();
  352.     streampos sseekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  353.     streampos sseekpos(streampos pos, int mode = ios::in|ios::out);
  354.  
  355.     virtual streampos seekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  356.     virtual streampos seekpos(streampos pos, int mode = ios::in|ios::out);
  357.     int seekmark(streammarker& mark, int delta = 0);
  358.     int sputbackc(char c);
  359.     int sungetc();
  360.     virtual ~streambuf();
  361.     int unbuffered() { return _flags & _IO_UNBUFFERED ? 1 : 0; }
  362.     int linebuffered() { return _flags & _IO_LINE_BUF ? 1 : 0; }
  363.     void unbuffered(int i)
  364.     { if (i) _flags |= _IO_UNBUFFERED; else _flags &= ~_IO_UNBUFFERED; }
  365.     void linebuffered(int i)
  366.     { if (i) _flags |= _IO_LINE_BUF; else _flags &= ~_IO_LINE_BUF; }
  367.     int allocate() { // For AT&T compatibility
  368.     if (base() || unbuffered()) return 0;
  369.     else return doallocate(); }
  370.     // Allocate a buffer if needed; use _shortbuf if appropriate.
  371.     void allocbuf() { if (base() == NULL) doallocbuf(); }
  372.     void doallocbuf();
  373.     virtual int sync();
  374.     virtual int pbackfail(int c);
  375.     virtual streambuf* setbuf(char* p, int len);
  376.     int in_avail() { return _IO_read_end - _IO_read_ptr; }
  377.     int out_waiting() { return _IO_write_ptr - _IO_write_base; }
  378.     virtual streamsize xsputn(const char* s, streamsize n);
  379.     streamsize sputn(const char* s, streamsize n) { return xsputn(s, n); }
  380.     streamsize padn(char pad, streamsize n) { return _IO_padn(this, pad, n); }
  381.     virtual streamsize xsgetn(char* s, streamsize n);
  382.     streamsize sgetn(char* s, streamsize n) { return _IO_sgetn(this, s, n); }
  383.     int ignore(int);
  384.     virtual int get_column();
  385.     virtual int set_column(int);
  386.     long sgetline(char* buf, _IO_size_t n, char delim, int putback_delim);
  387.     int sputc(int c) { return _IO_putc(c, this); }
  388.     int sbumpc() { return _IO_getc(this); }
  389.     int sgetc() { return _IO_peekc(this); }
  390.     int snextc() {
  391.     if (_IO_read_ptr >= _IO_read_end && __underflow(this) == EOF)
  392.       return EOF;
  393.     else return _IO_read_ptr++, sgetc(); }
  394.     void stossc() { if (_IO_read_ptr < _IO_read_end) _IO_read_ptr++; }
  395.     int vscan(char const *fmt0, _IO_va_list ap, ios* stream = NULL);
  396.     int scan(char const *fmt0 ...);
  397.     int vform(char const *fmt0, _IO_va_list ap);
  398.     int form(char const *fmt0 ...);
  399. #if 0 /* Work in progress */
  400.     int column();  // Current column number (of put pointer). -1 is unknown.
  401.     void column(int c);  // Set column number of put pointer to c.
  402. #endif
  403.     virtual streamsize sys_read(char* buf, streamsize size);
  404.     virtual streampos sys_seek(streamoff, _seek_dir);
  405.     virtual streamsize sys_write(const char*, streamsize);
  406.     virtual int sys_stat(void*); // Actually, a (struct stat*)
  407.     virtual int sys_close();
  408. };
  409.  
  410. // A backupbuf is a streambuf with full backup and savepoints on reading.
  411. // All standard streambufs in the GNU iostream library are backupbufs.
  412.  
  413. class filebuf : public streambuf {
  414.   protected:
  415.     void init();
  416.   public:
  417.     static const int openprot; // Non-ANSI AT&T-ism:  Default open protection.
  418.     filebuf();
  419.     filebuf(int fd);
  420.     filebuf(int fd, char* p, int len);
  421.     static filebuf *__new();
  422.     ~filebuf();
  423.     filebuf* attach(int fd);
  424.     filebuf* open(const char *filename, const char *mode);
  425.     filebuf* open(const char *filename, ios::openmode mode, int prot = 0664);
  426.     virtual int underflow();
  427.     virtual int overflow(int c = EOF);
  428.     int is_open() const { return _fileno >= 0; }
  429.     int fd() const { return is_open() ? _fileno : EOF; }
  430.     filebuf* close();
  431.     virtual int doallocate();
  432.     virtual streampos seekoff(streamoff, _seek_dir, int mode=ios::in|ios::out);
  433.     virtual streambuf* setbuf(char* p, int len);
  434.     streamsize xsputn(const char* s, streamsize n);
  435.     streamsize xsgetn(char* s, streamsize n);
  436.     virtual int sync();
  437.   protected: // See documentation in filebuf.C.
  438. //    virtual int pbackfail(int c);
  439.     int is_reading() { return eback() != egptr(); }
  440.     char* cur_ptr() { return is_reading() ?  gptr() : pptr(); }
  441.     /* System's idea of pointer */
  442.     char* file_ptr() { return eGptr(); }
  443.     // Low-level operations (Usually invoke system calls.)
  444.     virtual streamsize sys_read(char* buf, streamsize size);
  445.     virtual streampos sys_seek(streamoff, _seek_dir);
  446.     virtual streamsize sys_write(const char*, streamsize);
  447.     virtual int sys_stat(void*); // Actually, a (struct stat*)
  448.     virtual int sys_close();
  449. };
  450.  
  451. inline void ios::init(streambuf* sb, ostream* tie_to) {
  452.         _state = sb ? ios::goodbit : ios::badbit; _exceptions=0;
  453.         _strbuf=sb; _tie = tie_to; _width=0; _fill=' ';
  454. #ifdef _IO_NEW_STREAMS
  455.         _flags=ios::skipws|ios::dec;
  456. #else
  457.         _flags=ios::skipws|ios::dec|ios::dont_close;
  458. #endif
  459.         _precision=6; _arrays = 0; }
  460.  
  461. inline ios::ios(streambuf* sb, ostream* tie_to) { init(sb, tie_to); }
  462.  
  463. inline ios::~ios() {
  464. #ifndef _IO_NEW_STREAMS
  465.     if (!(_flags & (unsigned int)ios::dont_close)) delete rdbuf();
  466. #endif
  467. }
  468. #endif /* _STREAMBUF_H */
  469.